Xbasic

array append_arrays Method

Syntax

New_Array as P = <array>.append_arrays( Array1 as P, Array2 as P [, ArrayN as P ] )

Arguments

Array1Pointer

The first array.

Array2Pointer

The second array.

ArrayNPointer

Specify as many additional arrays as desired.

Returns

New_ArrayPointer

Returns the new property composed of the input arrays.

Description

Appends one or more arrays to an array.

Discussion

The <array>.append_arrays() method appends Array2 to Array1 to produce New_Array. Both Array1 and Array2 must have one dimension and have the same structure.

Example

dim cars[10] as P
cars.initialize_properties("manufacturer|model",<<%str%
Ford|Taurus
Ford|Focus
GM|Malibu
Dodge|Stratus
%str%)

dim trucks[10] as P
trucks.initialize_properties("manufacturer|model",<<%str%
Ford|F-150
Ford|Ranger
Dodge|Dakota
%str%)

dim vehicles[2] as P
vehicles.append_arrays(cars,trucks)

?  vehicles.dump_properties("manufacturer model")
= Ford Taurus
Ford Focus
Ford F-150
Ford Ranger
Ford Taurus
Ford Focus
GM Malibu
Dodge Stratus
Ford F-150
Ford Ranger
Dodge Dakota